home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / libcompress-zlib-perl / README < prev   
Text File  |  2008-05-16  |  3KB  |  121 lines
  1.  
  2.                              Compress-Zlib
  3.  
  4.                              Version 2.011
  5.  
  6.                                17th May 2008
  7.  
  8.        Copyright (c) 1995-2008 Paul Marquess. All rights reserved.
  9.           This program is free software; you can redistribute it
  10.            and/or modify it under the same terms as Perl itself.
  11.  
  12. DESCRIPTION
  13. -----------
  14.  
  15. This module provides a Perl interface to the zlib compression library.  
  16.  
  17. PREREQUISITES
  18. -------------
  19.  
  20. Before you can build Compress-Zlib you need to have the following
  21. installed on your system:
  22.  
  23.     * Perl 5.004 or better. 
  24.     * Compress::Raw::Zlib
  25.     * IO::Compress::Gzip
  26.  
  27. BUILDING THE MODULE
  28. -------------------
  29.  
  30. Assuming you have met all the prerequisites, the module can now be built
  31. using this sequence of commands:
  32.  
  33.     perl Makefile.PL
  34.     make
  35.     make test
  36.  
  37. INSTALLATION
  38. ------------
  39.  
  40. To install Compress-Zlib, run the command below:
  41.  
  42.     make install
  43.  
  44. TROUBLESHOOTING
  45. ---------------
  46.  
  47. Undefined Symbol gzsetparams
  48. ----------------------------
  49.  
  50. If you get the error shown below when you run the Compress-Zlib test
  51. harness it probably means you are running a copy of zlib that is
  52. version 1.0.5 or older.
  53.  
  54. t/01version.........Can't load 'blib/arch/auto/Compress/Zlib/Zlib.so' for 
  55.                     module Compress::Raw::Zlib: blib/arch/auto/Compress/Raw/Zlib/Zlib.so:
  56.                     undefined symbol: gzsetparams at ...
  57.  
  58. There are two ways to fix this problem:
  59.  
  60.     1. Upgrade to the latest version of zlib.
  61.  
  62.     2. Edit config.in and set the OLD_ZLIB variable to True.
  63.  
  64. Test Harness 01version fails
  65. ----------------------------
  66. If the 01version test harness fails, and the problem isn't covered by the
  67. scenario above, it probably means that you have two versions of 
  68. zlib installed on your system.
  69.  
  70. Run the command below to see if this is indeed the case
  71.  
  72.     make test TEST_VERBOSE=1 TEST_FILES=t/01version.t 
  73.  
  74. Try removing the one you don't want to use and rebuild.   
  75.  
  76. FEEDBACK
  77. --------
  78.  
  79. How to report a problem with Compress-Zlib.
  80.  
  81. To help me help you, I need all of the following information:
  82.  
  83.  1. The Versions of everything relevant.
  84.     This includes:
  85.  
  86.      a. The *complete* output from running this
  87.      
  88.             perl -V
  89.      
  90.         Do not edit the output in any way.
  91.         Note, I want you to run "perl -V" and NOT "perl -v".
  92.      
  93.         If your perl does not understand the "-V" option it is too
  94.         old. This module needs Perl version 5.004 or better.     
  95.  
  96.      b. The version of Compress-Zlib you have. 
  97.         If you have successfully installed Compress-Zlib, this one-liner
  98.         will tell you:
  99.  
  100.            perl -MCompress::Zlib -e 'print qq[ver $Compress::Zlib::VERSION\n]'
  101.  
  102.         If you are  running windows use this
  103.  
  104.            perl -MCompress::Zlib -e "print qq[ver $Compress::Zlib::VERSION\n]"
  105.  
  106.         If you haven't installed Compress-Zlib then search Compress::Zlib.pm
  107.         for a line like this:
  108.  
  109.           $VERSION = "2.011" ;
  110.  
  111.  2. If you are having problems building Compress-Zlib, send me a
  112.     complete log of what happened. Start by unpacking the Compress-Zlib
  113.     module into a fresh directory and keep a log of all the steps
  114.  
  115.         [edit config.in, if necessary]
  116.         perl Makefile.PL
  117.         make
  118.         make test TEST_VERBOSE=1          
  119.  
  120. Paul Marquess <pmqs@cpan.org>
  121.